home *** CD-ROM | disk | FTP | other *** search
- 182
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- NextActiveWindow
- --- RECORDSEPARATOR ---
- Platform:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Windows and Macintosh
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Description:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- baNextActiveWindow returns the next window to become active.
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Usage:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Result = baNextActiveWindow( TimeOut )
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Arguments:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Integer
- --- RECORDSEPARATOR ---
- TimeOut is the maximum amount of time to wait in ticks. A tick is equal to 1/60th of
- --- RECORDSEPARATOR ---
- a second. If TimeOut is 0, the function will wait indefinitely.
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Returns:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Integer.
- --- RECORDSEPARATOR ---
- Returns the handle of the next active window.
- --- RECORDSEPARATOR ---
- Returns 0 if the timeout occurs before another window becomes active.
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Examples:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Director:
- --- RECORDSEPARATOR ---
- set wnd = baNextActiveWindow( 300 )
- --- RECORDSEPARATOR ---
- -- waits for the next window to become
- --- RECORDSEPARATOR ---
- active, for a maximum of 5 seconds
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Authorware:
- --- RECORDSEPARATOR ---
- wnd := baNextActiveWindow( 600 )
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- Notes:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- This f
- --- RECORDSEPARATOR ---
- unction will not operate with versions of Authorware earlier than 3.0.
- --- RECORDSEPARATOR ---
- The next active window is defined as the next window that isn't the window of the
- --- RECORDSEPARATOR ---
- Director/Authorware calling program, or a dialog box or a splash screen. It would be
- --- RECORDSEPARATOR ---
- typically used after a baRunProgram or baOpenFile call to get the handle of the
- --- RECORDSEPARATOR ---
- window the program opens, and is particularly useful for applications such as
- --- RECORDSEPARATOR ---
- Netscape and Acrobat that open splash screens.
- --- RECORDSEPARATOR ---
- Here is an example of opening an Acrobat file in Director, and closing it when the
- --- RECORDSEPARATOR ---
- user is finished with it.
- --- RECORDSEPARATOR ---
- if baOpenFile( "readme.pdf" , "normal" ) > 32 then
- --- RECORDSEPARATOR ---
- --
- --- RECORDSEPARATOR ---
- open acrobat file
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- set wnd = baNextActiveWindow( 0 )
- --- RECORDSEPARATOR ---
- --
- --- RECORDSEPARATOR ---
- get handle of Acrobat window
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- baWaitForWindow( baWinHandle() , "active" , 0 )
- --- RECORDSEPARATOR ---
- --
- --- RECORDSEPARATOR ---
- wait till the Director window
- --- RECORDSEPARATOR ---
- -- is active ie Acrobat has been closed
- --- RECORDSEPARATOR ---
- -- or user switched back to Director
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- if baWindowExists( wnd ) then
- --- RECORDSEPARATOR ---
- baCloseWindow( wnd )
- --- RECORDSEPARATOR ---
- --
- --- RECORDSEPARATOR ---
- close Acrobat
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- end if
- --- RECORDSEPARATOR ---
- end if
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- See also:
- --- RECORDSEPARATOR ---
-
- --- RECORDSEPARATOR ---
- baWaitTillActive
- --- RECORDSEPARATOR ---
- baWaitForWindow
- --- RECORDSEPARATOR ---
- baActiveWindow